home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 41.zip / BS1 part 41 / Soundtracker Soundsystem.adf / soundcontroller.doc < prev    next >
Text File  |  1988-10-29  |  7KB  |  135 lines
  1.   --------------------------------------------------------------------------
  2.                     Sound Tracker Sound Controller V1.0
  3.        (C) copyright and written 1988 by Mr. Magic from THE PROPHETS AG
  4.   --------------------------------------------------------------------------
  5.  
  6. +------------------------------------------------------------+
  7. | Sound-Controller V1.0  (C) by Mr. Magic              XX XX | 
  8. | ---------------------------------------------------------- |
  9. | +--+ +-----------+ +-------+ +---------------------------+ |
  10. | | 0| |DF0:SONGS/ | |ST-01: | |                           | |
  11. | +--+ +---/-------+ +---/---+ +------/--------------------+ |
  12. | +--+    6             7    +--+    8     +---------------+ |
  13. | | 1| Begin Playing Sound in|4 |seconds   |Time:   9      | |
  14. | +--+                       +--+          +---------------+ |
  15. | +--+                                      +--+             |
  16. | | 2| Stop Playing Sound after starting in | 5|seconds      |
  17. | +--+                                      +--+             |
  18. | +--+                            +-----------------------+  |
  19. | | 3| Start/Stop Playing         |Remove Sound-Controller|  |
  20. | +--+                            +-----------------------+  |
  21. +------------------------------------------------------------+
  22.  
  23. Erklaehrung der einzelnen GadGets und ihre Funktionen.
  24. =========================================================================
  25. Nr. 0 : Mit diesem GadGet (Verschwindibus-GadGet) kann das Fenster vom Sound-
  26.         Controller vom Bildschirm entfernt werden. Der Sound-Controller bleibt
  27.         aber aktiv. Mit der HELP-Taste wird das Fenster des Sound-Controllers
  28.         wider auf dem Bildschirm erscheinen.
  29.     1 : Wenn ein Song geladen wurde kann mit diesem Gadget der Song gastartet
  30.         werden. Man wird aber erst etwas hoeren, wenn die Zeit (4) mit der
  31.         Zeit (9) uebereinstimmt. Das Gadget (1) wird beim selektieren mit
  32.         einem 'x' gekennzeichnet.
  33.     2 : Der Song wird angehalten, wenn die Zeit (5) mit der Zeit (9) ueber-
  34.         einstimmt. Man kann also mit den richtigen Einstellungen in den
  35.         Gadgets (4) und (5) den Song nach einer bestimmten Zeit erklingen
  36.         lassen und nach einer bestimmten Zeit (Gadget(5)) stoppen.
  37.     3 : Mit diesem Gadget (3) kann man den Song an- und nach belieben aus- 
  38.         schalten. Der Song spielt immer, ausser das Gadget (2) wurde 
  39.         als Zusatz mit selektiert. Dann stoppt der Sound naemlich nach der
  40.         angegebenen Zeit (5) seit dem selektieren des Gadgets Nr. (3).
  41.     4 : Soll der Song nicht sofort erklingen, so kann man in diesem Gadget
  42.         die Zeitverzoegerung einstellen (0-999 Sekunden). Es darf nicht
  43.         vergessen werden, diese Funktion (1) zu selektieren.
  44.     5 : In diesem Gadget wird der Zeitraum angegeben, der dafuer sorgt, dass
  45.         der Song nach einer bestimmten Zeitspanne stopt.
  46.         Folgendes Beispiel soll dies verdeutlichen:
  47.            Der Song soll in 20 sec starten und dann 60 sec spielen, danach
  48.            soll er stoppen.u
  49.            Es muessen folgende eintragungen gemacht werden:
  50.               Begin Playing Sound in 20 seconds
  51.               Stop Playing Sound after starting in 60 seconds
  52.            Die Gadgets 2 und 1 muessen selektiert werden.
  53.            Der Song spielt erst an, wenn der Timer (9) die Zeit 20 erreicht
  54.            hat. Dann spielt des Song solange, bis der Timer 80 anzeigt, da
  55.            der Sound ja 60 sec seit dem starten spielen sollte.
  56.     6 : Dieses Gadget gibt den Pfad an, von wo der Sound-Controller das
  57.         Song-File holen soll.
  58.     7 : Dieses Gadget gibt den Pfad an, von wo der Sound-Controller die
  59.         Instrumente holen soll.
  60.     8 : In dieses Gadget muessen Sie den Namen des Song-Files eingeben, dass
  61.         geladen werden soll. Nach Betaetigung der RETURN-Taste versucht
  62.         der Sound-Controller das Song-File zu laden. Sollte er es nicht
  63.         finden, so muessen Sie den Pfad und/oder den Namen des Song-Files
  64.         ueberpruefen.
  65. Remove Sound-Controller: Dieses Gadget beendet den Sound-Controller und gibt
  66.                          den benoetigten Speicher wieder frei.
  67.  
  68.  
  69. Der Sound-Controller muss vom CLI mit dem CLI-Befehl 'RUN C/SOUNDCONTROLL'
  70. aufgerufen werden.
  71.  
  72. Um vor Dia-Shows Song-Files zu setzen und abzuspielen, ist dieses Programm
  73. sehr gut geeignet. Der Sound-Controller kann naemlich auch Programmiert 
  74. werden. Dies hoert sich ziemlich schwierig an, ist es aber nicht.
  75. So wie der Amiga die 'Startup-Sequence' abarbeitet, so arbeitet der Sound-
  76. Controller auch so etwas aehnliches ab.
  77. Die Sequence, die er abarbeitet muss als Parameter beim aufruf uebergeben
  78. werden.
  79.  
  80. z.B. RUN C/SOUNDCONTROLL S/SEQUENCE
  81.  
  82. Die Sequence, die der Sound-Controller abarbeitet hat folgendes aussehen.
  83.  
  84. STSC
  85. .SONG:DF0:SONGS/!
  86. .INST:ST-01:!
  87. .SFIL:DRUM-SOLO!
  88. .PLMO:1!
  89. .STAR:00!
  90. .STOP:300!
  91. END.
  92.  
  93. Als erstes benoetigt der Sound-Controller eine Kennung, dass es sich um ein
  94. Sequence-File handelt. Die Kennung ist 'STSC'
  95. Dann folgt ein '.' und ein vier-stelliges Befehlswort und ein ':'
  96. Jetzt kommt der Parameter OHNE Zwischenraum und abschliessend ein '!', welches
  97. das Ende des Parameters kenzeichnet. Das '!' darf auf keinen Fall weggelassen
  98. werden, da es sonst zu Fehlern kommen kann.
  99. Nach der Kennung 'END.' kann noch ein Kommentar folgen, der aber vom Sound-
  100. Controller nicht erkannt wird.
  101. Die 'STAR'tzeit und die 'STOP'zeit muessen im bereich von 00-999 sein und
  102. duerfen nicht weniger als zwei-stellig dargestellt werden.
  103. z.B: .STAR:06     ---> start nach 6 Sekunden
  104.      .STOP:09     ---> stop nach 9 Sekunden spielen
  105. Es muss auch die Reihenfolge der Befehlswoerter eingehalten werden.
  106. Es gibt 4 PLMO (PLAYMODE, Abspielmoeglichkeiten)
  107.   1 : Der Song spielt immer, bis er vom Benuetzer unterbrochen wird.
  108.   2 : Der Song spielt solange, bis die Abspielzeit (.STOP:xxx) erreicht ist.
  109.   3 : Der Song Spielt ab der Anfangszeit (.STAR:xxx) bis er vom Benuetzer
  110.       gestoppt wird.
  111.   4 : Der Song faehngt erst an zu spielen, wenn die Start-Zeit erreicht ist
  112.       und stoppt erst, wenn er solange seit der Anfangs-zeit gespielt hatt,
  113.       wie bei .STOP:xxx angegeben ist.
  114.  
  115.  
  116. Der Sound-Controller macht bei Dia-Shows, Textverarbeitung, Copys usw. keine
  117. Probleme.
  118.  
  119. Den Sound-Controller hat MR. MAGIC von THE PROPHETS AG entwickelt, unter
  120. zuhilfenahme der Abspielroutine vom Sound-Tracker V2.0
  121.  
  122. Den Source-Code kann man bei THE PROPHETS AG bekommen
  123.  
  124. Solten sich einige Bugs im Programm befinden (mir sind keine bekannt)
  125. so sind wir fuer Hinweise dankbar.
  126.  
  127. In naher Zukunft wird wahrscheinlich ein UpDate (mit neuen??? Funktionen)
  128. bei THE PROPHETS AG zu bekommen sein.......
  129.  
  130.  
  131.                                            SIGNED Mr. Magic from THE PROPHETS
  132.  
  133.                                                                      HAVE FUN
  134.  
  135.